home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audiofile / AFgettrackids.z / AFgettrackids
Encoding:
Text File  |  1998-10-20  |  3.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaaffffGGGGeeeettttTTTTrrrraaaacccckkkkIIIIDDDDssss((((3333ddddmmmm))))                                          aaaaffffGGGGeeeettttTTTTrrrraaaacccckkkkIIIIDDDDssss((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afGetTrackIDs - get the list of track descriptor id's for the given
  10.      AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaaffffGGGGeeeettttTTTTrrrraaaacccckkkkIIIIDDDDssss((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee,,,, iiiinnnntttt ttttrrrraaaacccckkkkiiiiddddssss[[[[]]]]))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  18.      _f_i_l_e       expects an AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure, created when an audio file
  19.                 was opened by a call to aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(((()))).
  20.  
  21.      _t_r_a_c_k_i_d_s   expects an array of integer locations used to return a list of
  22.                 (unique) positive track id's which can be used to reference
  23.                 the audio tracks in a file.
  24.  
  25.                 If _t_r_a_c_k_i_d_s is a null pointer, aaaaffffGGGGeeeettttTTTTrrrraaaacccckkkkIIIIDDDDssss(((())))  will simply
  26.                 return the number of tracks in the file.  This value can be
  27.                 used to allocate a _t_r_a_c_k_i_d_s array, which can in turn be passed
  28.                 back to aaaaffffGGGGeeeettttTTTTrrrraaaacccckkkkIIIIDDDDssss(((()))).
  29.  
  30. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  31.      aaaaffffGGGGeeeettttTTTTrrrraaaacccckkkkIIIIDDDDssss(((()))) returns a nonnegative integer count of the number of
  32.      audio tracks in the file, or -1 in case of error.
  33.  
  34. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.      You can call aaaaffffGGGGeeeettttTTTTrrrraaaacccckkkkIIIIDDDDssss(((())))) with a null _t_r_a_c_k_i_d_s pointer to obtain the
  36.      number of audio tracks contained in _f_i_l_e.
  37.  
  38.      You can use this count to allocate a _t_r_a_c_k_i_d_s[] buffer, which you pass
  39.      back to aaaaffffGGGGeeeettttTTTTrrrraaaacccckkkkIIIIDDDDssss to obtain a list of unique track id's. You can then
  40.      use these id's to reference the various tracks in the file.
  41.  
  42.      For the current release of the Audio File Library, this routine is a
  43.      placeholder, since all currently supported file formats always contain
  44.      one track which should be referenced using the constant ID
  45.      AAAAFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTRRRRAAAACCCCKKKK.
  46.  
  47. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  48.      This function may return more than one track.  Future releases of the
  49.      Audio File Library may support formats which contain multiple tracks.  An
  50.      application might want to reject such a file, or perhaps use the first
  51.      track.  The library does define the correct behavior.
  52.  
  53. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  54.      afOpenFile(3dm), afReadFrames(3dm), afWriteFrames(3dm),
  55.      afInitTrackIDs(3dm)
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.